Compendium Deluxe 1

home *** CD-ROM | disk | FTP | other *** search

/ Compendium Deluxe 1 / LSD Compendium Deluxe 1.iso / a / programming / debuggers / scypmon.lha / scypmonv1.8 / Scypmon.doc < prev next >

Wrap

Text File | 1994-01-13 | 22.2 KB | 567 lines

Description for Scypmon V1.8 \==========================/ Release: -------- (C) by Jörg Bublath 1989-1994 Developing this program took me a long time, so I'd appreciate a little financial support. Because I hate all those "crippled unregistered versions", I won't do this myself to get my DM 5,- (or US $5) shareware fee (that really isn't much, is it ?), but I appeal to all those users out there to be honest ! I know it costs a big pile of money to pay or all those shareware- programs that one has. So I would like to suggest a new shareware concept: I call it "you share me - I share you", which means that all authors of shareware-programs let me use their programs for free, and they mine, but all those who don't write any useful programs can begin doing so - or pay! Update-services, which would cost money of course, aren't included in the "share each other" concept. All those guys who helped me with ideas, test-reports and routines to make Scypmon better, don't have to pay shareware either (but I don't mind when they do :-)) Of course all authors of good Non-Shareware Software are included in my offer, too! Just send me notice and your program. I prohibit changes to the program (incl. source) and documentation. Scypmon is free to be spread on public-domain and shareware disks especially on Fred Fish's AmigaLibDisks, as long as they are sold for a reasonable charge that is less than US $6 or DM 8.- . For use in commercial products the permission of the author is required. Scypmon may be copied and distributed via electronic networks such as the Internet, also it may be moved on anonymous ftp-servers, mail-boxes or BBS's. The Copyright stays by the Author. Scypmon is Shareware, that means you may keep Scypmon in archived form without paying, but when you unpack it and use it, you have to pay the fee mentioned above, or share your programs with me. General Information: This monitor uses a full-screen-editor with or without automatic insertion and an additional command-history of 1K. The cursor can be moved using the cursor-keys or by positioning it with your mouse. If you leave the screen up or down, the screen will be scrolled in the opposite direction. If the status-line is inverted, then the monitor is active. The headline also shows if you are in insert or overwrite mode. When you use the scrolling and there is an output-line of the "m", "i" or "d"-command on the screen the next logical line of this command will appear instead of the empty line. Using the cursor-keys with shift will cause scrolling by one full screen. Some other keys that are used in a special way: HELP (=CTRL-l) : Clear Screen + Cursor Home Shift + HELP (CTRL-K) : Clears the rest of the line starting at the actual cursor-position. Shift + DEL : Inserts one blank On the numeric keypad: Shift + 7 : Cursor home (upper left corner) Shift + 1 : Cursor end (lower left corner) Shift + 0 : Switch between insert and overwrite mode Shift + . : Del F1 : Jsr-dissassemble in Shift + F1 : Switch mode "m" and "d" in full-screen display F2 : Jsr-dissassemble out (explained later) Alt + Cursor Up : Previous command-history entry Alt + Cursor Down : Following command-history entry During screen-output: SPACE : Stop screen-output, continue: SPACE again CTRL-C : Break screen-output Left mouse-button : Hold to stop screen-output Exceptions: ----------- All exceptions except #08 (privelege violation) and the trap #0x - commands will not cause a guru, but instead a monitor output stating "exception #xx at xxxxxx" if the "-p"-option to patch the exceptions is activated. In addition you will receive some detailed information about the task that crashed (see "e"-command) and it should no longer be in the task-list. If you crash your machine totaly there will be certainly only one help for you : ctrl + amiga + amiga ! Calling the monitor from CLI: ----------------------------- You can call the monitor by typing: scypmon [-bdp] [-P <xpos> <ypos>] [-S <xsize> <ysize>] [-s <pubscreen>] [-f <fontname> <fontsize>] [batchfile] "-b" will make the monitor start itself in background, which means that its window will not be activated at startup. "-p" will patch the exception vectors to catch gurus. If this option is not used, Amiga-Dos will do what ever it likes with crashes. "-d" Tries to use the dis.library to disassemble, which means that Scypmon will know 68030-commands. Assembling is still only possible for 68000, and even this will sometimes cause trouble with the dis.library because of a slightly different syntax. "-P" give new coordinates for the window to open. "-S" give a new size for the window. CAUTION: If the window cannot open due to wrong coordinates, Scypmon won't run. There will be no error-message! "-s" Running 2.0+ you are able to have public-screen. This option makes it possible to open the scypmon on any public screen. "-f" For use of other than the fonts (systemfont) defined with preferences. This batchfile may be any textfile eg. edited with "ed" that contains a list of monitor commands. This option is very useful for absolute programming, when you need to load graphic or sound data into memory. eg.: { o 60000 7f000 00 l "graphic.data" 70000 l "sound.data" 60000 l "sinus-table" 7e000 x } This batchfile will clear the memory from 60000 to 7f000, load the three programs absolutely into memory and leaves the monitor afterwards. A clarification to the memory allocations: To prevent allocmem-chaos, the monitor organizes memory-allocations in its own way. You have 8 segments (0-7) that can be used for allocations. If you use one segment twice then the old memory allocated in this segment will be freed. When you leave the Monitor all segments will be given back to Amiga-Dos. This prevents a chaos like in c-mon when you load several programs and don't know afterwards where and how much, so you have to reset to have a clean memory again. Menus ------ The options "-p" and "-d" can also be changed while the monitor is running by using the menus. You also can leave scypmon by menues or call up a helpwindow. The help-window is just a short overview over the command and no replacement for the doc-file. The commands (in alphabetical order): -------------------------------------- All Values (in assemble/dissamble,too !) have to be entered hexadecimal (you don't have to use $xxx - only xxx) ! [ ] : Expressions in these brackets are optional ( ) : Expressions in round brackets have to be entered start : Is a hex-expression that indicates a start-adress stop : Is a hex-expression that indicates an end-adress target : Is a hex-expression that indicates a target-adress name : Is an ASCII-string segment: A memory segment between 0 and 7 When dealing with hex-adresses you can use the variables ^(a-z) in most cases. ---------------------------------------------------------------------------- [?] (expression) : Calculate The expression will be calculated and printed out decimal, hexadecimal, binary and as 4-char ASCII string. Inside the expression you have to use a "$" to indicate a hex-number, a "#" or nothing to indicate a decimal number, a "%" to indicate a binary-number and max. 4 ASCII chars "<str>" or '<str>'. In addition, you can get the value of a hex-address with "&(hexaddress)", use uservariables with "^(a-z)" and the following systemvariables: ^s = Startadress of last load ^e = Endadress of last load ^S0-7 = Startadress of segment 0-7 ^L0-7 = Length of segment 0-7 For calculation you may use "+", "-", "*" and "/". You can also use brackets - The calculation will be done in mathematical order (first "*" and "/" then "+" and "-") eg.: ? $1000-(#100+%010)*2 ---------------------------------------------------------------------------- ^(a-z)=(expression) : set variable This sets one of the 26 user-variables to the given value (compare "?") Caution: The variables ^s and ^e are used by the monitor to indicate the last start- and end-address of absolute loading. eg.: ^a=^a+$20-(1+4)*5 ---------------------------------------------------------------------------- <b (blocknr) (start) [len] [!] : Block Load >b (blocknr) (start) [len] : Block Save Loads/Saves (len) bytes from disk starting with block number (blocknr). If you don't give a [len] , $200 bytes = 1 sector will be loaded/saved. As device will be used the one fixed the with "V"-command. Attention: You have to enter all values in hex ! The "!"-Option overrides the memory check, to overload memory already allocated by DOS. eg.: <b 1a2 70000 ---------------------------------------------------------------------------- <o (offset) (start) [len] [!] : Offset Load >o (offset) (start) [len] : Offset Save Loads/Saves (len) bytes from disk starting with offset (offset). If you don't give a [len] , $200 bytes = 1 sector will be loaded/saved. As device will be used the one fixed the with "V"-command. Attention: You have to enter all values in hex ! The "!"-Option overrides the memory check, to overload memory already allocated by DOS. eg.: <o 30000 70000 ---------------------------------------------------------------------------- <t (tr) (hd) (sc) (start) [len] [!] :Track Load >t (tr) (hd) (sc) (start) [len] :Track Save Loads/Saves [len] bytes from disk starting at track, head, sector. If you don't give a [len] the default of $1400 bytes = 1 side of a track will be loaded/saved. As device will be used the one fixed the with "V"-command. Attention: You have to enter all values in hex ! The "!"-Option overrides the memory check, to overload memory already allocated by DOS. eg.: <t 0a 01 06 70000 ---------------------------------------------------------------------------- a (start) : Assemble Will cause an output of a "," followed by the given adress and sets the cursors to the right tab-position to assemble. Instead of using this command you can simply dissassemble the adress and overwrite it. eg.: a 70000 ---------------------------------------------------------------------------- A (segment) (start) (len) : Allocate Absolute Uses AllocAbs (-204) to allocate memory and remembers the memory in the segment-list. eg.: A 0 70000 1000 ---------------------------------------------------------------------------- A (segment) (len) : Allocate Memory If you don't give a alloc-adress allocmem (-198) will be used and the memory remembered in the segment-list. eg.: A 0 1000 ---------------------------------------------------------------------------- b (start) : Boot Checksumm Calculates the checksum of a bootblock ($0400 bytes !) and inserts it. eg.: b 70000 ---------------------------------------------------------------------------- B (stop) : Breakpoint A breakpoint will be set to the adress (stop), then the program will start according to the entered PC at the "r"-command. After execution the breakpoint will be cleared and the register will be given out. eg.: B 70200 ---------------------------------------------------------------------------- c (start) (stop) (target) : Compare T he memory (start) to (stop) will be compared with the (target) and all differing bytes will be reported. eg.: c 70000 71000 72000 ---------------------------------------------------------------------------- C (start) : Calc Block CheckSumm Calculates the checksum of a normal diskblock and inserts it. eg.: C 70000 ---------------------------------------------------------------------------- CD [name] : Change Directory The actual Path will be set to [name]. eg.: CD df0:c ---------------------------------------------------------------------------- d (start) [stop] : Dissassemble The given memory will be disassembled. Before each output-line there will be printed a "," as a marker for the scroll-function and for assembling (so you can assemble when overwriting). eg.: d 70000 70020 ---------------------------------------------------------------------------- D [name] : Directory If no name is given, the actual directory will be printed out, otherwise the given path will be used. eg.: D df0:c ---------------------------------------------------------------------------- e "(taskname)" : Examine Task e (taskadress) The given task is searched and will be printed with name, adress, priority, signals and stackusage (and CLI-command). e.g.: e "Scypmon 1.4" --------------------------------------------------------------------------- f (start) (stop) (v1) [v2...] [!] : Find This command searches after a expression that can be defined as a mixture out of hexnibbles, "*", or strings. When nibbles are replaced by the joker "*" then the command will find any possible matches. If the "!" is added then it will be a not-find, that means if you search for "00 !" you will find all places where no 00 exists. eg.: f 70000 80000 01 "hello" 0* 4a3b "xx" 00 ---------------------------------------------------------------------------- fd (start) (stop) (v1) [v2...] [!] : Find and disassemble Like the normal find-command, but if something is found it will be dis- assembled if it stands on an even adress - then the monitor waits for any key. If you press 'ESC' you will exit find-mode, otherwise the search will be continued and if found the next line will be disassembled. If you are only interested in the arguments of a command, the necessary number of jokers ('*') has to be put in front if you want a sensible output. eg.: fd 70000 80000 **** 00dff180 ---------------------------------------------------------------------------- fr (start) (stop) (target) : Find Relative Searches for a word between (start) and (stop) that points relatively to (target). This word can lie between (target)-$8000 to (target)+$8000. Very useful to find branches and xxxx(pc)-adressmodes. Won't find short-branches. eg.: fr 70000 72000 71000 ---------------------------------------------------------------------------- F (segment) : Free Memory The given segment will be freed by using freemem (-210) or UnLoadSeg. eg.: F 0 ---------------------------------------------------------------------------- g (ziel) : Goto The program will be started at the given address under use of the at "r" defined stacks and registers and return after "rts" into the monitor. eg.: g 70000 ---------------------------------------------------------------------------- h : Show history The command-history will be displayed on the screen. e.g.: h ---------------------------------------------------------------------------- i (start) [stop] : ASCII Dump The given memory will be printed as ASCII-dump. As a marker for scrolling a ";" is used. eg.: i 70000 70020 ---------------------------------------------------------------------------- l ["](name)["] (start) [!] : Load absolute File The given file is loaded at the given adress. Using the "M"-command the monitor looks up how many bytes of memory are free, and loads only that many bytes. If you want to overload memory allocated by DOS you can cancel this control with "!". The start- and end-address will be saved into the variables ^s and ^e for further use, especially in batchfiles. eg.: l "program.obj" 70000 ---------------------------------------------------------------------------- ld ["](name)["] (segment) : Load Dos-File Load an Amiga-Dos file using the LoadSeg-Command, allocs the memory and inserts it into the segment-list. eg.: ld "dir" 0 ---------------------------------------------------------------------------- m (start) [stop] : Memory Dump The given memory will be printed as a hex-dump. Each line will be marked by a ":" for scrolling and overwriting. eg.: m 70000 70020 ---------------------------------------------------------------------------- M (start) : Show Free Memory Looks up how many bytes of free memory there are, starting at the given address, and print the amount. e.g.: M 30000 ---------------------------------------------------------------------------- o (start) (stop) (v1) [v2...] : Occupy The memory between (start) and (stop) will be filled with the given values. eg.: o 70000 71000 01 23 45 ---------------------------------------------------------------------------- O [name] : Set Output Device Here you can enter the device/filename that is used with the "p"-command. If you don't give a name you will see the actual device. (Default: prt:) The outputfile will be opened at the first use of the "p"-command and closed when you leave the monitor or specify a new output-file. e.g.: O df0:testfile ---------------------------------------------------------------------------- p (any command) : Print using Output Device You can add a "p" as prefix before every command to have an output on screen and chosen output-device (eg.: printer). eg.: pd 70000 70200 ---------------------------------------------------------------------------- P (start) : Print Text Prints a text in memory on the screen. The text should be ended by a $00. The output can be paused by space and stopped by CTRL. eg.: P 70000 ---------------------------------------------------------------------------- r : Register Give you all processor-registers (used at "goto" or "trace"). You can change them by overwriting. eg.: r ---------------------------------------------------------------------------- s ["](name)["] (start) (stop) : Save absolute File The given memory will be saved. eg.: s "objectcode" 70000 72000 ---------------------------------------------------------------------------- S [segment] : Segment List Print the data of the given segment - if it is an Amiga-Dos File you will get a list of all segments of this file. If no segment is given, you will get a general list of all 8 segments. eg.: S 0 ---------------------------------------------------------------------------- t (start) (stop) (target) : Tansfer The memory from (start) to (stop) will be transfered to (target). eg.: t 70000 71000 71000 ---------------------------------------------------------------------------- T [start] : Trace Starting at [start] (or if not given at the defined PC) the monitor will dissassemble one command. You can start tracing now, using the following keys: return: execute this command and show next x: leave the trace-mode r: show registers n: set a breakpoint on the next command and start program. useful to escape from "dbf"-loops. j: the next command will be executed, then one longword will be taken from the stack and a breakpoint will be set to the adress that is defined by the longword. Effect: if the actual command is a jsr/bsr the whole subroutine will be executed before returning to trace- mode. Otherwise the program will come back to trace- mode at the next "rts". Be careful: if something is taken from the stack before "rts" you will have a nice crash ! g: will behave like goto (leave trace-mode) eg.: T 70000 ---------------------------------------------------------------------------- V <devicename> : Device Changes the device used with the track-commands (default: df0). eg.: V df0 ---------------------------------------------------------------------------- w (start) ["](name)["] : Write ASCII The given string will be written as ASCII-code into memory. eg.: w 70000 "hello world" ---------------------------------------------------------------------------- x : Exit Leaves Scpymon. Allocated Memory will be restored. eg.: x ---------------------------------------------------------------------------- Jsr-Disassemble ---------------- This option is useful to trace a program by brain. When the F1-Key is pressed the assembly-expression in the actual cursor-line will be calculated (source-part) and the actual dissassemble-adress will be pushed on a roundstack for 16 values. Afterwards, if the actual command was a jsr/jmp or branch-command, the memory at the calculated adress will be disassembled, otherwise it will be printed using the "m"-command. The jsr-disassembler knows the following expressions: $xxxx,$xxxx(pc),$xx(ax),$xx(ax,dx),$xx(ax,ax). As registers the actual defined one will be taken. If the actual cursorposition is on a "m"-line, the next 8 digits will be taken as long adress and shown by "m"-command again. If you are on any other line, the hexadress at cursorposition will be scanned and shown by "m" (Attention: You can't use F2 to go back here!) If you have seen enough about your subroutine/data you can press f2 to get back to your starting point. The data will be saved on a round-stack, which means that you can press F1 as often as you want and don't have to worry about a stack overflow, but you can only take the last 16 "f1"s back with f2. If you are not happy about the mode the monitor chose while pressing f1 ("m" or "d"), you can change this by pressing shift+F1. News for V1.6: Window! Sizable! Fonts! Public-Screen! More compatible! Better Trackloading.... News for V1.7: Minor Bugfixes, Trackdisk now works REALLY on all devices, Enforcerhits removed, removed german docs. News for V1.8: Really minor bugs (especially on 68000 machines) removed. Known Bugs: ----------- Under V1.3 Scypmon seems to complain about fontwidth - just ignore or use 2.0 :) Credits: -------- Thanx to all my friends on the internet who helped testing. MrScary for reformatting the docs. Tobias "Top" Walter for the dis.libary. (Hey - I support your V2 for over a year now, but when will you develop it? :) Final Remarks ------------- The fact that I didn't recover bugs when testing, doesn't mean that there are no bugs at all, so if you have new ideas or find bugs, feel free to send your them to my address, including a disk and the return-postage for sending you a new version. Jörg Bublath Holzheimerstr. 4, E07 W-8390 Passau Germany or reach me by email under: bublath@forwiss.uni-passau.de or find me on IRC on #amigager under the nickname 'Skull'